home *** CD-ROM | disk | FTP | other *** search
Text File | 1998-01-24 | 63.2 KB | 1,478 lines |
-
- ץ³∞∞∞∞³ץ
- ף§ õ ∧ף
- ף Ø ף
- ץ³∞∞∞∞³ץ ץ³∞∞∞∞³ץ ץ³∞∞∞∞³ץ ץ³∞³ץף ף ףץ³∞³ץ ץ³∞∞∞∞³ץף∞∞∞∞ף
- ף§ õ ∧ا õ ∧ا õ ∧ا ∧ף ף ף§ ∧ا Ø ∧ף ףץץ
- ף Ø ף Ø ף Ø ף ף ף ף ף ∞∞∞∞ף ף
- ף ף ף∞∞∞∞∞ ף ף∞∞∞ף∞∞∞∞∞ף ף∞∞∞ף∞∞∞∞∞ף∞∞∞∞ף ף ף∞∞∞ף
- ף ף ף ף ף ף ף ף ף∞∞ ף ף ף ף ף ף
- ף ף ף ף ף ף ף ף ף ף ף ף ף ף ף
- ף ף ∧ا ף ∧ا ף ∧Ø ף ף ף ا ף ∧Ø ף ף
- ף ץץ³∞ ∞³ץץץץ³∞ ∞³ץץץץ³∞ףץץץץץØץץץץØ ףץץץץץף∞³ץץץץ³∞ף ף ף
- ------ף ף -------------------------------------------- sns -ף§ ף ∧Ø-----
- õ õõõ ףץץץץØ õõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõ ∞³ץץץץ³∞ õõõ
-
-
-
- PaCifiST v0.48
- ~~~~~~~~~~~~~~
-
- programmé par Frederic Gidouin
- (frederic.gidouin@hol.fr)
-
- Emulation YM2149 & driver
- Soundblaster par Arnaud Carré
- (leonard@mygale.org)
-
- (c) 1996-1998
-
-
- Dernière Mise à jour: Samedi 24 Janvier 1998
- -------------------------------------------------------------------------------
-
- TABLE DES MATIERES
-
- 0. Changements dans ce document
-
- 1. Introduction
- 1.1 Qu'est-ce que PaCifiST?
- 1.2 Pourquoi devrais-je l'utiliser?
- 1.3 Caractéristiques
- 1.4 Développements futures
- 1.5 Combien ça coûte?
-
- 2. Installation
- 2.1 Matériel Requis
- 2.2 Quelques concepts utilisés dans PaCifiST
- 2.2.1 Un mot sur le Moniteur
- 2.2.2 L'émulation Vidéo
- 2.2.3 Les modes de vitesse ("Speed Modes")
- 2.2.4 L'émulation des lecteurs
- 2.2.5 Le son
- 2.3 Avant de démarrer l'émulateur...
-
- 3. Configuration
- 3.1 Référence des directives du fichier INI
- 3.1.1 Section "System" (Système)
- 3.1.2 Section "Screen" (Ecran)
- 3.1.3 Section "Debug" (Debogage)
- 3.1.4 Exemple de fichier PACIFIST.INI
- 3.2 Paramètres de la ligne de commande
- 3.3 Configuration depuis le Moniteur
- 3.4 L'écran de sélection de disquette
- 3.5 L'écran des ports joysticks
-
- 4. Divers
- 4.1 Quelques Conseils
- 4.2 Le VBE 2.0
- 4.3 Images de disquettes
- 4.4 Correspondances pour le clavier
- 4.5 Captures d'écran
- 4.6 Sauvegarde de jeux
- 4.7 Enregistrement de musiques .YM (PARTIE NON ENCORE
- 4.7.1 Utilisation TRADUITE EN
- 4.7.2 Informations Techniques FRANCAIS)
- 4.8 Detection & Utilisation de PaCifiST
- 4.9 Freezing/Unfreezing [*NOUVEAU*]
-
- 5. Le Moniteur
- 5.1 L'écran du moniteur
- 5.2 Les Commandes du moniteur
- 5.3 Evaluateur d'expressions [*NOUVEAU*]
-
- 6. Ressources & Remerciements
- 6.1 Programmes connexes
- 6.1.1 Autres Pages Web
- 6.1.2 Utilitaires
- 6.2 Ressources
- 6.3 Remerciements
- 6.4 Pour me contacter
-
-
- -------------------------------------------------------------------------------
-
- 0. Changements dans ce document (depuis la version 0.47)
- ========================================================
-
- Nouvelles directives INI: vbemode, midi
-
- Moniteur: commands e,fz,uz,bar,baw
- évaluateur d'expression
- touche MONO/COLOR
-
- Freezing/Unfreezing
-
- MIDI OUT, shifter STE
-
-
- 1. Introduction
- ===============
-
-
- 1.1 Qu'est-ce que PaCifiST?
- ---------------------------
-
- PaCifiST est un émulateur Atari ST pour PC. Il s'agit d'un
- émulateur logiciel, ce qui veut dire qu'il ne requiert aucune carte
- d'extension avec des composants du ST, votre PC suffit.
-
- Il vous permettra d'utiliser de nombreux logiciels Atari ST sur votre PC.
-
-
- 1.2 Pourquoi devrais-je l'utiliser?
- -----------------------------------
-
- Si vous avez été un possesseur d'Atari ST, la réponse c'est: LA NOSTALGIE!
- C'est vraiment sympa de pouvoir ré-utiliser ses vieux programmes.
-
- De nos jours, il y a des jeux pour PC d'une taille gigantesques, avec des
- graphismes & des sons incroyables. Mais à part quelques uns, ils sont
- généralement vite lassants et n'ont pas "d'âme".
-
- L'Atari ST n'est pas le seul ordinateur possédant de bons jeux (j'apprécie
- également le C64 et l'Amiga) mais si vous avez déjà joué à Super Sprint,
- Stunt Car Racer, Dungeon Master ou Colonial Conquest... Alors vous avez une
- idée de ce qu'est un BON JEU.
-
- Bien sur, il n'y a pas que des jeux sur Atari ST! Cette machine était par
- exemple largement utilisée par les professionnels de la musique, et on peut
- trouver à peu près tous les types de logiciels
-
-
- 1.3 Caractéristiques
- --------------------
-
- PaCifiST émules les composantes suivantes d'un Atari ST normal:
-
- Motorola 68000 L'émulation du 68000 est écrite entièrement en
- assembleur Intel. Tous les aspects du processeurs sont
- respectés, à l'exception des instructions en BCD
- (incorrectes). Le prefetch est émulé, pour peu qu'on
- utilise l'option "pref" du moniteur. Dans la mesure
- où cela ralentit considérablement la vitesse globale
- de l'émulateur, il est conseillé de n'activer cette
- option uniquement pour passer certaines routines
- foireuses. L'émulation du 68030 arrivera dans un
- futur plus ou moins lointain.
-
- Shifter (Vidéo) Les 3 modes graphiques standards du ST sont supportés.
- Vous pouvez choisir entre une émulation monochrome
- (haute résolution) ou couleur (basse et moyenne
- résolutions. Toute l'émulation vidéo est réalisée 100%
- en assembleur.
- Certains effets spéciaux (changement de palette,
- "rasters" sont possibles, à partir du moment où vous
- utiliser un driver VBE2.0 et que vous passiez en mode
- LINE (ligne) d'émulation vidéo. Un autre mode possible
- (depuis la version 0.44) est le mode MIXED: Il permet
- en plus le changement de résolution en plein milieu
- d'un écran.
- Depuis la version 0.45, PaCifiST est aussi capable
- d'émuler des résolutions étendues, mais cela ne
- marchera, sous certaines conditions, qu'avec des
- applications systèmes.
- Pour le moment, seuls les overscans bas sont rendus.
- PaCifiST 0.48 emuler le shifter du STE (cf directive
- INI ste). [*NOUVEAU*]
-
- 6301 (Clavier) Ce processeur est utilisé pour la gestion du clavier,
- de la souris, du joystick et de l'horloge interne dans
- un ST réel. Le comportement exact de cette puce n'est
- pas émulé (cela prendrait trop de temps), une simple
- simulation est suffisante et se précise à chaque
- nouvelle version de l'émulateur. Une souris PC est
- nécessaire. Si aucun joystick PC n'est détecté au
- démarrage (ou si vous l'avez inhibé dans PACIFIST.INI),
- une émulation du joystick ST au clavier est proposée.
-
- YM-2149 (Son) Cette puce sonore est émulée si une carte son supportée
- est reconnue (SB & GUS). L'émulation YM est réalisé
- par Arnaud Carré, également auteur de STSound. Les
- samples STF sont également + ou - bien restitués.
-
- MFP Les interruptions VBL, FDC, ACIA, TIMER C sont
- correctes ainsi que les timers A, B & D en "events
- count mode" (mode de comptage d'évenements). La HBL
- n'est pas bien précise, mais c'est aussi le cas sur
- un vrai ST.
-
- FDC / HDC PaCifiST utilise 3 niveaux pour l'émulation disque:
- Gemdos, Bios et matérielle. Le niveau Gemdos permet
- l'utilisation de vos disques durs/CD-ROM PC sous
- Atari. Pour les émulations Bios et matérielle, des
- "images" de disquettes sont utilisées pour simuler
- de vraies disquettes. Vous pouvez également utiliser
- votre lecteur de disquette PC (CE N'EST PAS DU TOUT
- RECOMMANDé!!!)
- Depuis la v0.45, le formatage est possible, mais il
- est simulé et nécessite que l'image de disquette ait
- la même géométrie (paramètres logiques) que le format
- voulu par l'application.
-
- I/O Ce qui est envoyé vers le port parallèle est écrit
- dans le fichier PARALLEL.OUT.
- Le port série n'est pas encore fonctionnel.
-
- MIDI [*NOUVEAU*] PaCifiST 0.48 dispose d'une emulation
- MIDI OUTPUT très primitive via le port d'une
- Soundblaster. Pour se faire, vous devez avoir "midi"
- configuré dans le fichier INI, mais alors l'émulation
- de la puce sonore est désactivée. Testé avec le
- jeu "Eco".
-
- Blitter Le blitter du STE est à présent émulé
-
- 1.4 Développements Futurs
- -------------------------
-
- Il reste de nombreuses choses à faire, ainsi que d'autres à corriger.
- La liste des choses à faire est comme suit, sans ordre précis:
-
- - meilleurs sons digitalisés STF
- - corriger les monceaux de bogues restants
- - Son DMA STE
- - Accélérer l'émulation du 68000 encore un peu
- - Overscans & Syncscrolls
- - Meilleur moniteur (évaluateur d'expression, points d'arrêt
- conditionnels...)
- - Port Série qui marche
- - Programme de transfert Atari<->PC
- - Une option pour enregistrer/restaurer l'état du ST émulé
- - Emulation 68030
-
- Ecrivez-moi si vous avez d'autres idées réalisables.
- D'autres améliorations sympa sont possibles:
-
- - Emulation native du processeur 6301
- - Support Midi total
- - Emulation du FDC avec les lecteurs de disquettes PC (bof!!!)
-
- Mais je n'ai ni les docs, ni le courage de le faire pour le moment.
-
-
- 1.5 Combien ça coûte?
- ---------------------
-
- Avant, ce programme était Shareware (partagiciel). A présent il est
- Giftware (On peut traduire par doniciel).
- ========
-
- Vous êtes libres et encouragés de le diffuser autour de vous, à partir du
- moment où vous ne gagnez pas d'argent se faisant.
-
- ...MAIS vous êtes hautement encouragés ^_^; de contribuer... Je passe
- beaucoup de temps sur ce projet et aimerai beaucoup recevoir quels que type
- de remerciements que se soient. M'envoyer une certaines sommes d'argent
- serait fantastique, et me permettrait de payer ma note de téléphone. Sinon,
- vous pouvez m'envoyer une simple carte postale, un *vieux* film de SF,
- un CD fait maison ou... Un bière locale!
-
- Je déteste les programmes sharewares bridés, je ne veux pas en arriver la. En
- retour j'espère juste que ceux qui en ont les moyens voudront bien contribuer
- d'eux mêmes.
-
- Merci a tous ceux qui l'ont d'ors et déjà fait.
-
- 2. Installation
- ===============
-
-
- 2.1 Matériel Requis
- -------------------
-
- PaCifiST est conçu pour un environnement DOS. Il marchera à priori mieux depuis
- le DOS, mais se satisfera d'une sessions DOS sous Windows 3.11, 95 ou NT. On
- m'a dit qu'il fonctionnait également sous OS/2 (assurez-vous juste que l'option
- MOUSE_EXCLUSIVE_ACCESS soit OFF), mais pas sous DosEmu depuis Linux.
-
- La configuration MINIMALE sur laquelle vous devriez utiliser ce programme est
- un 486DX-100. Il marchera avec moins que ça, mais ne vous attendez pas alors
- à des prouesses. Je développe PaCifiST sur un AMD 586-133 (environ un P75),
- et la vitesse est généralement supérieure à celle d'un ST de base à 50
- images/secondes, le son émulé à 22Khz, avec la plupart des jeux. Bien sur
- certaines routines (plasma) ralentissent plus que d'autres l'émulation.
-
- PaCifiST nécessite environ 1.5 Mo de mémoire lui même, à quoi il faut
- ajouter la taille de mémoire vive ST que vous voulez. Avec 8Mo de mémoire,
- vous aurez au mieux un Atari ST avec 6Mo.
-
- Une souris est NECESSAIRE. Vous pouvez choisir entre un driver intégré (souris
- branchée sur le port série seulement) ou un driver standard que vous aurez
- pris soin de démarrer. Le driver intégré ne fonctionne pas sous Win95, je
- ne l'ai fait que pour corriger un bug rencontré par quelques personnes.
- Si PaCifiST ne détecte pas de joystick, il utilisera les touches flèches
- de votre clavier (quand la diode NumLock/VerrNum (Pavé Numérique) est
- éteinte seulement) pour en simuler un. Vous pouvez afficher l'écran de
- l'émulation joystick avec F4 depuis le moniteur.
-
- Une carte son compatible soundblaster ou GUS est nécessaire si vous désirez
- entendre quelque chose.
-
- En plus de tout ça, vous devez impérativement posséder un fichier "dump"
- d'un TOS (le système d'exploitation en ROM) ST. Lancez le programme ST
- joint DUMP_TOS.PRG (dans le répertoire STFILES) pour sauver son TOS sur
- disquette.
-
- PaCifiST doit absolument être exécuté depuis son répertoire, qui devra
- contenir le fichier PACIFIST.INI (fichier texte de configuration) et PATCH.H68
- (qui contient un peu de code 68000 nécessaire à l'émulation Gemdos).
-
-
- 2.2 Quelques concepts utilisés par PaCifiST
- -------------------------------------------
-
- Cette section donne quelques explications sur des concepts qu'il est
- souhaitable de comprendre pour exploiter au maximum l'émulateur.
-
- 2.2.1 Un mot sur le Moniteur
- ----------------------------
-
- Par defaut, quand vous démarrer PaCifiST, vous atterrissez sur l'écran du
- moniteur. Pour lancer l'émulation proprement dite, vous devez taper "g" (go)
- et appuyer sur ENTREE. Vous pouvez rappller cet écran à tout moment en
- appuyant sur la touche qui est entre ECHAP et TAB (souvent un petit 2). Vous
- aurez besoin de passer par là pour quitter l'émulateur, réinitiliser l'Atari,
- choisir un mode vidéo de restitution ou d'autres options.
-
- IMPORTANT: Parfois, quand vous rappelez l'écran du Moniteur, il se peut que
- le clavier ne réponde pas bien. En ce cas, pressez simultanément sur les
- touches SHIFT, ALT & CTRL.
-
- La commande "x" permet de revenir au DOS.
-
- Reportez-vous à la section qui résume les commandes du Moniteur pour plus
- d'explications.
-
-
- 2.2 L'émulation Vidéo
- ---------------------
-
- Il existe 4 différentes façons d'émuler la vidéo. Néanmoins, seul la
- basse résolution est affecté.
-
- Le premier mode (utilisé par défaut) est appelé le "Screen-Oriented" (orienté
- écran), car tout l'écran de l'Atari ST est affiché d'un seul coup. De ce fait,
- une seule palette (16 couleurs) est utilisable et aucun effet spécial n'est
- possible. C'est le mode idéal pour se servir d'applications GEM, il est aussi
- le plus rapide.
-
- Le second mode est appelé "Line-Oriented" (orienté ligne), et cette fois-ci
- chaque ligne de l'écran Atari est construite à la fois. C'est le mode idéal
- pour les jeux et les démos car il autorise de nombreux effets spéciaux.
-
- Le troisième mode est le "Mixed mode" (mode mixte) et requiert un driver VBE
- proposant une résolution de 640x400x256 en mode linéaire. Identique au mode
- "orienté ligne" mais il autorise en plus le changement dynamique de résolution
- en plein milieu d'une image (comme dans les jeux d'aventures de Magnetic
- Scroll & de Level 9, et dans la Calimero Demo par exemple).
-
- Le dernier mode (nouveau dans la version 0.45) est le "custom mode" (mode
- personnel) et lui aussi nécessite une résolution VBE de 640x480x256. TOUT CELA
- EST EXPERIMENTAL, ne l'utilisez que depuis le bureau du GEM et avec le TOS2.06.
- Vous ne pouvez pas choisir ce mode une fois l'émulateur lancé, il faut le faire
- au démarrage (option RENDER (rendu) du fichier INI ou en paramètre de la ligne
- de commande).
-
- Mode orienté écran (Screen-Oriented mode)
- - ne permet pas d'effet spécial
- + fonctionne très bien sous Windows même fenêtré)
- + rapide
- + marche sur toute les configurations
-
- Mode orienté écran (Line-Oriented mode)
- - plus lent
- - driver VBE2.0 recommandé
- - fonctionne SEULEMENT en plein écran sous Windows
- + différentes résolution PC (320x200, 640x480...)
- + capable de gérer les changements de palette (rasters),
- overscan bas (avec plus de 200 lignes).
-
- Mode mixte (Mixed-Mode)
- - bien plus lent
- - nécessite un driver VBE2.0 avec une résolution de 640x480x256
- ou 640x400x256.
- - ne marche qu'en plein écran sous Windows
- + capable d'émuler plus ou moins bien les changement de palette
- et de résolution dans l'image.
-
- Vous pouvez passer d'un de ces modes d'émulation vidéo à un autre facilement
- (touche F1 sous le moniteur).
- IMPORTANT: le mode "orienté ligne" est désactivé en haute et moyenne
- résolution. Le mode Mixte est désactivé en haute résolution.
-
- Mode personnel (Custom-Mode):
- - *très* lent
- - nécessite un driver VBE2.0 avec une résolution de 640x480x256.
- - ne marche qu'en plein écran sous Windows
- - une fois choisi ce mode, vous ne pouvez plus changer de
- mode sans quitter l'émulateur.
- + extension de la résolution ST à 640x480 en 16 couleurs.
- d'autres résolutions seront peut-être ajoutées dans le futur.
-
-
-
- 2.2.3 Les Modes de Vitesse (Speed Modes)
- ----------------------------------------
-
- La version 0.4 a vu l'arrivée de 2 modes de vitesse d'émulation: ST et MAX. Le
- mode par défaut est le ST-speed (vitesse ST): Meme avec le plus rapide des
- Pntium, la vitesse n'excédera jamais celle d'un ST à 8Mhz. C'est absolument
- nécessaire pour certains programmes. L'autre mode, MAX-speed (vitesse maxi)
- fait que l'émulateur se synchronise avec la vitesse du PC. Néanmoins ce mode
- n'est compatible qu'avec des applications systèmes.
-
- Passer d'un mode de vitesse à l'autre en cours d'émulation n'est PAS RECOMMANDE,
- mieux vaut le faire avant.
-
-
- 2.2.4 L'émulation des lecteurs
- ------------------------------
-
- PaCifiST propose 3 façons d'émuler les unité de stockage.
-
- - LECTEUR DE DISQUETTES PC (A:)
-
- J'ai ajouté ce mode quasi-contraint par bon nombre de demandes.
- Ce n'est PAS RECOMMANDE!!! Il subsiste de nombreux problèmes, notamment
- la détection de changement de disquette & la protection. Si la
- directive <pcdrive> (lecteur PC) est utilisée au démarrage et qu'aucune
- image de disquette n'est choisie pour le lecteur ST A:, alors PaCifiST
- bootera sur le lecteur physique du PC. Toutefois, j'insiste: Utilisez
- plutôt des images de disquettes... ^_^;
- La clause PCDRIVE semble donner de meilleur résultat sous Windows 95
- que sous DOS.
-
- - IMAGES DE DISQUETTE (Disk Images):
-
- Il s'agit d'un fichier qui contient à la suite tous les secteurs d'une
- disquette. Pour les programmes émulés, il est similaire à une vraie
- disquette insérée dans un lecteur. Les images de disquette fonctionnent
- avec tous les programmes, même ceux qui utilise directement le
- contrôleur de disque (FDC). PaCifiST reconnaît les images de disquette
- à leur extension ".ST".
- Vous pouvez choisir 2 images au démarrage de l'émulateur avec la
- directive "IMAGE=", ou en cours d'émulation depuis l'écran de Sélection
- de disquette (DISK SELECTION SCREEN).
- Depuis la version 0.41, PaCifiST peut aussi utiliser des fichiers MSA.
-
- - REPERTOIRES MONTéS (Mounted Directories):
-
- Cela ne marchera que pour les programmes utilisant le GEMDOS pour leur
- accès aux fichiers. Cette méthode vous permet de "monter" des
- répertoires de votre PC comme des unités Atari. Par exemple, si vous
- montez "D:\ATARI" sur le lecteur C: de l'Atari au démarrage, les
- programmes lancés depuis l'émulateur verront le répertoire D:\ATARI
- et tous ses sous-répertoires comme étant sur un lecteur C:.
- Vous pouvez très bien monter des partitions entières, mais ce n'est
- pas conseillé: Vous avez plutôt intérêt à n'utiliser qu'un répertoire
- ou deux. De cette façon, même en cas de gros plantage, aucun de
- vos fichiers PC ne seront affectés.
- Vous ne pouvez pas changer l'affectation de répertoire montés une
- fois PaCifiST lancé, ce n'est possible qu'au démarrage.
-
-
- 2.2.5 Le Son
- ------------
-
- Les sons digitalisés du STF sont très mal rendu pour l'instant (mais ça
- dépend beaucoup de la routine qui les joue). Vous pouvez supprimer cette
- émulation dans le fichier INI ou avec la touche F5 sous le moniteur.
-
- Les cartes sons supportés sont la Soundblaster et la Gravis Ultrasound. Des
- drivers pour d'autres cartes ne sont pas prévus.
-
- L'émulateur tentera d'abord de détecter une GUS, puis une Soundblaster...
-
- SOUNDBLASTER
- ============
-
- PaCifiST n'essayera pas de la trouver tout seul, mais se basera sur la
- variable d'environnement BLASTER. Avant de démarrer l'émulateur, assurez-vous
- qu'elle est bien définie. Reportez-vous à la documentation de votre carte
- sonore si vous n'y parvenez pas. Si vous connaissez les paramètres, sous
- DOS tapez:
-
- SET BLASTER= Axxx Ix Dx
-
- Axxx étant la valeur du Port. Par exemple A220
- Ix étant le numéro d'interruption. Par exemple I7
- Dx étant le canal DMA. Par exemple D1
-
-
- GRAVIS ULTRASOUND
- =================
-
- Comme pour la SB, la variable d'environnement ULTRASND doit être définie.
-
- SET ULTRASND= ppp,d,d',i,i'
-
- Où ppp est la valeur du port (220,240...)
- Où d est le canal DMA
- Où i est le numéro d'interruption
-
-
- 2.3 Avant de démarrer l'émulateur
- ---------------------------------
-
- PaCifiST est configuré par l'intermédiaire d'un fichier texte: "PACIFIST.INI".
- Vous pouvez l'éditer avec n'importe quel éditeur (l'EDIT du DOS, le NOTEPAD de
- Windows) pour modifier le comportement de l'émulateur. Certaines options
- peuvent aussi être spécifiées en paramètre sur la ligne de commande.
- Ce document contient une section détaillant toutes les options. Gardez tout
- de même une copie du fichier INI original, en cas de problème. Avec
- le paramètre de ligne de commande /ini vous pouvez précisez un autre fichier
- de configuration que PACIFIST.INI.
-
- La première fois que vous allez utiliser PaCifiST, il y a quelques trucs
- à changer dans la configuration selon votre système.
-
- La chose la plus importante est d'indiquer à PaCifiST où trouver votre fichier
- TOS. Charger le fichier INI avec un éditeur de texte and allez dans la section
- [system]. Vous pouvez mettre des lignes en commentaires en plaçant un ";" en
- début de ligne. Ensuite, indiquez le nom de votre fichier TOS (TOS image):
-
-
- tos= tos162.img ;vous devez spécifier le chemin d'accès complet au fichier
- ;si il n'est pas dans le répertoire de PaCifiST.
-
-
- Placez autant de clauses "TOS=" que vous avez de fichiers TOS, de façon à
- pouvoir passer de l'un à l'autre pendant l'émulation. Le dernier spécifié
- sera celui par défaut. Il est conseillé pour chaque clause TOS= de placer
- aussi un court commentaire pour décrire le fichier, par exemple en donnant
- la version du TOS, le pays d'origine, etc... par exemple:
-
- tos= tos162.img, "TOS 1.62 (fr)"
-
-
- Le fichier INI livré avec PaCifiST contient un exemple de configuration de TOS.
-
- Assurez-vous aussi la première fois que tous les chemins dans les clauses
- IMAGE et MOUNT sont valides.
-
- 3. Configuration
- ================
-
- Il y a 3 niveaux de configuration. Le fichier INI contient les options
- globales, tandis que les paramètres de ligne de commande n'affecte que la
- session en cours. Enfin, certaines options peuvent être changées en cours
- de route depuis le moniteur.
-
- Un fichier appelé JOY.CFG sera aussi créé dans le répertoire de PaCifiST dès
- que vous calibrerez un éventuel joystick.
-
-
- 3.1 Réferences des directives du fichier INI
- --------------------------------------------
-
-
- Les tabulations, espaces et le texte après ";" sont ignorés.
-
-
- 3.1.1 Section "System" (Système)
- --------------------------------
-
- TOS = <fichier>,"comnt" Nom du fichier TOS. Si plusieurs sont déclarés,
- le dernier sera utilisé par défaut. Vous pouvez
- passer d'un TOS à l'autre depuis le moniteur.
-
- AUTORUN = [yes|no] Si YES (Oui), PaCifiST démarrera de suite
- l'émulation, sans passer par le moniteur.
-
- RAMSIZE = [n|512k] Spécifie la taille de la RAM (mémoire vive)
- affectée à l'Atari ST émulé. Les valeurs
- possibles sont de 1 à 14 Mo et 512k. Depuis
- la version 0.47, vous pouvez également indiquer
- des multiples de 0.5 (0.5, 2.5, etc...)
-
-
- SOUND = [yes|no] Indique si vous voulez une émulation du son
- ou non.
-
- SAMPLES = [yes|no] Indique si vous voulez une (mauvaise) émulation
- des sons digitalisés (logiciels) du STF
-
- VOLUME = <n> Indique le volume sonore. Le maxi est 255, et
- c'est également la valeur par défaut (il est
- préférable de régler le son de manière externe).
-
- MIDI = [yes|no] Emulation du MIDI OUT? Carte soundblaster
- nécessaire, mais alors l'émulation de la
- puce sonore n'est plus possible. [*NOUVEAU*]
-
- INTERNALMOUSE=[yes|no] Le défaut est non. Mettez cette directive à
- yes si vous rencontrez des problèmes de souris.
- Cela ne marche *que* sous DOS.
-
- SENSITIVITY=[1-10] Sensibilité de la souris (incompatible avec la
- clause INTERNALMOUSE) de 1 à 10 (défaut 5).
-
- MOUSECOM = [1|2] Dans le cas ou INTERNALMOUSE est mis à yes,
- désigne le port série de votre souris.
-
- SERIAL = [yes|no] Autorise/Supprime l'émulation du port série.
- mieux vaut mettre à non: De toute façon ce
- n'est pas encore près.
-
- JOYSTICK = [yes|no] Demande à PaCifiST de ne pas utiliser de
- joystick PC. Une émulation clavier est de
- toute façon possible.
-
- LAPTOP = [yes|no] Si à "yes", c'est l'autre touche CTRL qui sera
- utilisée pour émuler le bouton de feu du
- joystick. (option pour ordinateurs portables)
-
- LEDS = [yes|no] Si à "yes" (défaut), la LED "scroll lock"
- clignotera pour indiquer une activité du
- lecteur de disquette du ST émulé.
-
- KBDELAY = n Délai de réponse du clavier de 1 à 10 (défaut
- 3). Vous pouvez aussi changer cette valeur
- depuis le moniteur. Le processeur clavier du
- ST (6301) envoie des paquets d'information
- au 68000. Ce paramètre permet de simuler un
- délai entre chaque information des paquets.
-
- IMAGE = <fichier>,drv Cette directive donne le nom d'un fichier
- image de disquette devant être "insérée"
- dans le lecteur A: ou B:
- 2 clauses IMAGE peuvent être utilisées
- conjointement dans le fichier INI. Vous pouvez
- également préciser un lecteur (A ou B) pour
- forcer l'image dans un lecteur particulier.
-
- MOUNT = <chemin absolu> Demande à l'émulateur de "monter" un répertoire
- PC comme unité Atari. Le chemin précisé doit
- être donné de façon absolue (depuis la racine,
- par exemple MOUNT=C:\PACIFIST\STFILES).
-
- PCDRIVE = [yes|no] PaCifiST doit-il utiliser le lecteur de
- disquette du PC. Le Défaut (et la valeur
- conseillé) est "no".
-
- PARALLEL = [yes|no] Emulation du port parallèle ou non
-
- STE = [yes|no] Emulation du shifter STE
-
-
- 3.1.2 Section "Screen" (Ecran)
- ------------------------------
-
- MONOCHROME = [yes|no] Comme vous le devinez, PaCifiST doit-il émuler
- un moniteur couleur ou monochrome.
-
- FASTVIDEO = [yes|no] Mettre à "yes", surtout si votre carte vidéo
- est lente. Cela n'est utile qu'en mode
- d'émulation vidéo orientée-écran.
-
- REFRESHRATE = <n> Le défaut est 1, ce qui veut dire que *tous*
- les écran Atari sont converti en écran PC
- (50 fois par seconde). Si votre PC est un lent,
- vous pouvez mettre une autre valeur.
-
- RENDER = [screen|line|mixed|custom]
-
- Démarre PaCifiST dans un mode d'émulation
- vidéo précis.
-
- VBEMODE = [?|n] Donne le mode VBE à utiliser par défaut
- en mode ligne. [*NOUVEAU*] cf 4.2
-
- 3.1.3 Section "Debug" (Déboggage)
- ---------------------------------
-
- Ces paramètres ne sont guères utiles que pour moi, et ceux qui veulent un
- peu "bidouiller": examiner les interruptions, les évenements clavier,
- désassembler du code...
- Vous devez impérativement posséder une version compilée "DEBUG" de l'émulateur
- pour en tirer profit.
-
- LOGFILE = <fichier> Nom d'un fichier de LOG où enregistrer
- certaines informations plus ou moins
- techniques.
-
- TRAPIRQ = [all|none|v] Demande à PaCifiST de stopper l'exécution des
- programmes quant une interruption se produit.
- Le défaut est de n'en intercepter aucune.
- "all" signifie toute ("none" aucune). Si le
- nombre v est positif, cette exception est
- rajoutée à la liste, s'il est négatif elle est
- retirée. Vous pouvez spécifier une liste de
- valeurs séparées par des virgules.
-
- LOGIRQ = [all|none|v] Comme ci-dessus, mais PaCifiST se contentera
- d'écrire un bloc d'information dans le fichier
- de LOG sans interrompre l'exécution.
-
-
- 3.1.4 Exemple de fichier PACIFIST.INI
- -------------------------------------
-
-
- [system]
-
- tos = c:\pacifist\tos.rom, "Mon TOS" ; donne le chemin d'accès au TOS
-
- image=c:\pacifist\disks\boot.st ; nom d'un fichier image pour le lecteur ST A:
- mount=c:\pacifist\stfiles ; C:\PACIFIST\STFILES deviendra C: pour le ST
- mount=c:\pacifist\games ; C:\PACIFIST\GAMES deviendra D: pour le ST
- autorun = no ; afficher le moniteur
-
- pcdrive=no ; :) pas d'émulation dans le lecteur du PC
-
- [video]
-
- refreshrate = 2 ; n'émule qu'un écran de l'Atari sur deux
- monochrome = no ; émulation d'un moniteur COULEUR
- render=screen ; utiliser le rendu vidéo par écran
-
- [debug] ; seulement si PaCifiST est compilé par DEBUG
- ; ignorez cette section
-
- logfile = f:\debug.out ; le fichier de log où mettre les infos
- logirq = none ; liste des exceptions vide
- logirq = 0x21 ; logguer les appels à GEMDOS
- logirq = 0x1c,69 ; logguer aussi les VBL & les TIMERS C
- trapirq = 5 ; monitorer les divisions par zéros
-
-
- 3.2 Paramètres de la ligne de commande
- --------------------------------------
-
- PACIFIST [/option1] [/option2] [....]
-
- Certaines directives du fichier INI peuvent être outrepassées sur la ligne
- de commande. Les options valides sont:
-
-
- /[h(elp)|?] liste des options
- /ini <fichier> utilise le nom précisé plutot que PACIFIST.INI
- /refreshrate n comme la directive REFRESHRATE
- /mono [yes|no] comme la directive MONOCHROME
- /autorun [yes|no] comme la directive AUTORUN
- /ramsize [n|512k] comme la directive RAMSIZE
- /sound [yes|no] comme la directive SOUND
- /image <filename> désigne une image de disquette prioritaire
- /mount <path> désigne un chemin à monter prioritairement
- /maxspeed comment en mode "maxspeed" (vitesse maxi)
- /pcdrive [yes|no] comme la directive PCDRIVE directive
- /render [screen|line|mixed|custom] comme la directive RENDER
- /ymrecord allocation mémoire pour l'enregistrement des YM
- /vbemode [?|n] comme la directive VBEMODE
-
-
- 3.3 Configuration depuis le Moniteur
- ------------------------------------
-
- Lisez la section de référence du Moniteur pour une description complète de
- toutes les commandes. Si vous ne connaissez pas l'assembleur 68000, seules
- les commandes suivantes vous serons directement utiles:
-
- g "go", lancer l'émulation
- x "eXit" quitter l'émulateur et revenir au DOS
- vol <n> définie le volume (0-255)
- help aide rapide
-
- Touches utiles:
-
- [F1] Changer entre les modes de rendu vidéo SCREEN (écran), LINE (lignes),
- MIXED (mixte).
-
- [F2] Choisir un mode vidéo utilisé en mode LINE (lignes). Disponible
- seulement si un driver VBE2.0 avec mémoire vidéo linéaire est détecté
- au démarrage. Les modes 256 couleurs sont les plus rapides, mais les
- 32k & 64k donnent de meilleurs résultat.
- Le mode par défaut peut être précisé en utilisant la directive INI
- (ou le paramètre de ligne de commandes) vbemode. [*NOUVEAU*] cf 4.2
-
- [F3] Change le mode de vitesse (MAX/ST). Peu stable.
-
- [F4] Affiche l'écran d'émulation joystick.
-
- [F5] Emulation des sons digitalisés logiciels du STF
-
- [F10] Change entre l'émulation MONO/COULEUR. Comme pour un vrai ST,
- la machine émulée est réinitialisée. [*NOUVEAU*]
-
- [F12] Affiche l'écran de sélection de disquette. On peut aussi utiliser
- F12 *pendant* l'émulation.
-
-
- 3.4 L'écran de sélection de disquette
- -------------------------------------
-
- Utilisez F12 à tout moment pour afficher cet écran. Il est utilisé pour
- changer les disquettes insérées dans les lecteurs A: & B: du ST émulé.
-
- Le sélecteur n'affiche pas tous les fichiers, mais seulement ceux dont
- l'extension est .ST, .MSA, .ZIP et .RAR ainsi que les répertoires
- et les unités valides.
-
- Utilisez ESC pour quitter l'écran. <HAUT>, <BAS>, <PAGE PREC.>, <PAGE SUIV.>,
- <HOME>, <FIN> pour naviguer dans la liste de gauche. <TAB>, <DROITE>, <GAUCHE>
- choisissent entre le lecteur de disquette A: & B. <ENTREE> insérera l'image
- sélectionné dans le lecteur courant. Il y a également une option pour
- virtuellement "l'enlever".
-
- La touche <*> vous permet de forcer la non-exécution des bootsecteurs qui
- sont normalement exécutables. Par défaut, PaCifiST est en mode 'KEEP BOOT'
- (conserver le boot) mais en mode 'SKIP BOOT' (outrepasser le boot) il fera
- croire a l'Atari qu'aucun boot n'est exécutable.
- Pratique si une image de disquette contient un virus ST (inoffensif pour
- votre PC!).
-
- Bien sur, si la disquette insérée doit être bootée (pour qu'un jeu démarre),
- il faut également effectuer un reset de l'Atari ST (CTRL-BREAK sous émulation,
- ou commande 'reset' sous le Moniteur).
-
- Le sélecteur de disquettes considère les archives ZIP & RAR comme des
- répertoires conventionnels, vous pouvez dont grouper vos images de disquette
- dans de tels archives. Les désarchiveurs PKUNZIP.EXE & RAR.EXE doivent se
- trouver dans le chemin du DOS (ou le répertoire de PaCifiST) pour que cette
- possibilité vous soit présentée. PaCifiST utilisera le répertoire temporaire
- précisé dans la variable d'environnement TEMP pour ces extractions.
-
- IMPORTANT: Aucune écriture effectuée sur une image MSA ou dans une archive
- ne sera répercutée dans l'image originale.
-
- 3.5 L'écran des ports joysticks
- -------------------------------
-
- Cet écran vous permet de choisir entre différents types d'émulations pour
- chacun des 2 ports joystick de l'Atari. Pour l'instant, seuls 3 choix sont
- possibles: "none" (pas d'émulation), "PC Joystick #1" et "Numeric Pad" (pavé
- numérique).
-
- - PC Joystick #1 n'est disponible que si un joystick analogique a
- été détecté au démarrage de l'émulateur. Vous devez également calibrer
- cette manette: Tapez "c" depuis cet écran, ou "calib" sous le Moniteur.
-
- - Le pavé numérique peut donc être utilisé pour simuler un joystick ST,
- le voyant NumLock (VerrNum) doit alors être désactivé.
- la touche CTRL de droite (ou gauche si laptop=yes dans le fichier INI)
- sert de bouton de feu.
-
-
- 4. Divers
- =========
-
- 4.1 Quelques Conseils
- ---------------------
-
- - MIEUX VAUT NE PAS UTILISER DE CACHE DISQUE AVEC ECRITURE DIFFEREE
- (genre SMARTDRV C+)
-
- - Quelques fonctions du GEMDOS ne sont pas super bien émulées. Par
- exemple sur les unités "mountées", le sélecteur de fichiers du
- GFA BASIC ne marche pas bien.
-
- - Si vous avez des difficultés à configurer PaCifiST, vous avez tout
- intérêt à utiliser une "front-end interface" (interface de config),
- un utilitaire spécialement créé dans ce but. Il en existe une
- dizaine, dont AssiST sous DOS (Par Aengus Jankowsky) & PaCiLOAD
- sous Windows 95 (par Andrew Knipe).
-
- - Si vous utiliser une version "DEBUG" de PaCifiST et que vous avez
- beaucoup de mémoire, placer le fichier de LOG dans un ramdisque.
-
- - Eviter d'utiliser PCDRIVE. C'est lent, peu stable et bien moins
- pratique qu'une image de disquette.
-
-
- 4.2 Le VBE 2.0
- --------------
-
- Pour que le mode de rendu vidéo par ligne (LINE MODE) donne toute sa mesure,
- mieux vaut disposer d'un driver VBE 2.0, comme par exemple Scitech's
- Display Doctor (http://www.scitechsoft.com), un shareware.
-
- Si vous posséder une carte graphique basée sur une puce de la famille S3,
- il existe également S3VBE par D.Meschede qui lui est gratuit.
-
- [*NOUVEAU*]: Vous pouvez changer le mode VBE2.0 utilisé par défaut en mode
- LINE au démarrage, en utilisant la directive INI "vbemode". D'abord il
- faut créer un fichier listant les modes autorisés. Pour cela ayez
- "vbemode=?" dans PACIFIST.INI (ou démarrez l'émulateur avec /vbemode ?)
-
- Un fichier VBEMODES.LST est créé, ressemblant à ca:
-
- --- PaCifiST authorized VBE Modes ---
- 0x0163 320 200 8
- 0x0164 320 240 8
- 0x014f 400 300 8
- 0x010d 320 200 15
- 0x012e 320 240 15
- 0x0137 320 400 16
- 0x0138 320 480 16
-
- Bien sur, ce sera différent d'une configuration à une autre. La première
- colonne indique le nom du mode, puis on trouve les résolutions X et Y,
- puis le nombre de bits par couleurs (8 pour 256 colors, 15 pour 32000,
- 16 pour 65000).
-
- Donc si vous voulez le mode 320x240 en 256 couleurs par défaut en mode
- LINE, il faut avoir "vbemode=0x0164" dans le fichier INI.
-
-
- 4.3 Images de disquettes
- ------------------------
-
- Ces fichiers ne contiennent juste que les secteurs d'une vraie disquette
- mis les uns à la suite des autres dans l'ordre logique.
-
- PaCifiST n'a pas besoin d'informations particulières, parce que les paramètres
- de la disquette (nombre de secteurs, pistes...) sont contenus dans le premier
- secteur. Si ces valeurs semblent erronées, PaCifiST tentera de les deviner
- au mieux.
-
- Vous pouvez créer vos propres fichiers images à partir de vos disquettes
- ST par le programme IMGBUILD. Il vous permet également de créer des images
- vierges de tailles diverses. Reportez-vous à la section RESSOURCES pour
- plus d'informations.
-
- PaCifiST est également capable d'utiliser directement des fichiers au
- format MSA.
-
-
- 4.4 Correspondances pour le clavier
- -----------------------------------
-
-
- Le clavier pendant l'émulation correspond à celui d'un Atari réel, excepté:
-
- - HELP est mappé sur PagePrec
- - UNDO est mappé sur PageSuiv
-
- - CTRL+Break fait un reset (+SHIFT pour un reset à froid)
-
- - En émulation joystick, si NumLock est on, les touches flechées
- correspondent aux directions de la manette de jeux (CTRL = feu),
-
- F12 ramène au premier plan l'écran de sélection de disquette.
- La touche en dessous ECHAPE ramène le Moniteur.
-
-
- 4.5 Captures d'écran
- --------------------
-
-
- Cette possibilité est apparue dans la version 0.44 de PaCifiST. Elle vous
- permet d'enregistrer l'image actuellement à écran dans un fichier PCX
- créé dans le répertoire de PaCifiST. Tous les fichiers seront appelés
- "PCST_xxx.PCX"
-
- Vous avez juste à presser la touche "Arrêt Défil" (ScrollLock), mais ce n'est
- pas possible dans tous les modes vidéos.
-
- * modes suppportés:
-
- - Haute résolution du ST
- - Basse résolution en SCREEN MODE
- - Basse résolution en LINE MODE (256 & Hicolor)
- - MIXED MODE (depuis PaCifiST v0.45)
-
- * non supportés:
-
- - Moyenne résolution du ST
-
-
- 4.6 Sauvegarde de jeux
- ----------------------
-
- Le formatage dans PaCifiST est feint puisqu'il ne modifie pas la structure
- des images de disquettes. Vous pouvez donc formater des disques de sauvegarde
- pour certains jeux (voir ci-dessous), a condition que vous utilisiez des
- images prévues pour: Même nombre de faces, de pistes et de secteurs par piste.
-
- Exemples:
-
- CARRIER COMMAND - Disquette double face, 10 secteurs
- [imgbuild /blank /name SAVE.ST /sector 10]
-
- DEUTEROS - Disquette standard (double face, 9 secteurs)
- [imgbuild /blank /name SAVE.ST)
-
-
- 4.7 Enregistrement de musiques .YM
- ----------------------------------
-
- If you know PaCifiST, then you're likely to know STSound as well.
-
- STSound (DOS & Win95 version exist) is a software YM2149 emulator. Virtually
- all ST soundchips (as well as Spectrum & Amstrad CPC ones) can be replayed.
- This program is written by Arnaud Carre, and you can download the latest
- version at: http://www.mygale.org/09/leonard/.
-
- PaCifiST can now record such soundfiles. You must start the emulator with the
- /ymrecord switch to allocate the needed extra memory (20 minutes of sound).
- Use the "record" option under the monitor to start/stop the recording.
- Files starting from YM_001.BIN will be created. BEWARE: Existing files are
- overwritten without any warning.
-
- Those files are "raw recorded" and huge. You should then use the LHA
- archiver with a commandline like: lha a -h0 -m <ym file.ym> <raw file.bin>
- to generate the final YM files
-
- - PaCifiST can only record plain soundchips. Not Sampled ones.
- The YM5! format is now used.
-
- - Record only in ST speed. Don't worry if PaCifiST is under the 8Mhz,
- it doesn't affect the replaying speed of the tune later on.
-
- - Don't spread widely unperfect/uncomplete .YM files. Starting the
- recording exactly when the music starts is not always easy and
- some knowledge in music ripping may help.
- With v0.46, you can use the <play> monitor command in order to
- locate the exact start/end point in the music. A loop point can
- also be specified.
-
- - Read the DOC that comes with STSOUND.
-
-
- 4.7.1 Utilisation
- -----------------
-
-
- You start/stop the recording under the monitor:
-
- record : display status
- record on : start/resume recording
- record off : stop/pause record. You then choose between:
-
- (F)ree - free the recording memory, abort current record.
- (P)ause - pause the recording.
- (S)ave - save to a file called YM_xxxx.BIN.
-
-
- 4.7.2 Informations Techniques
- -----------------------------
-
- Use a DEBUG build of PaCifiST, to have the ability to set breakpoints,...
- The best method is to locate the installation & replay routines. Look the
- VBL & the MFP Timer vectors (command "status"), set a breakaccess at
- "ff8802", etc...
-
- The YM registers are recorded during the first rasterline. You must start
- the recording just after the replay routines is called for the first time.
- This will work most of the time:
-
- 1) find the installation routine
- 2) set a breakpoint at its end
- 3) go till then, remove the breakpoint.
- 4) use the command "trap 1c" (stop emulation on VBL)
- 5) "g" - go till the first VBL IRQ since music is installed
- (repeat this twice in some cases)
- 6) "trap 1c", remove VBL trapping
- "record on", start recording
- 7) if the music ends itself, stop recording, it's done. The end.
- If it loops, you'd better wait the second complete rolling before
- stopping. Then use YMTOOL in order to create an *exact* looped YM,
- but it's not always possible.
-
-
-
- 4.8 Detection & Utilisation de PaCifiST
- ---------------------------------------
-
- Il est maintenant possible aux programmes ST de détecter la présence de
- PaCifiST. Dans le future des registres "hardware" supplémentaires sont
- susceptibles d'être ajoutés. ;-)
-
- Vous avez juste à appeler la fonction XBIOS Vsync() avec les registres
- D6 & D7 étant "Emu?". Si votre programme est exécuté depuis PaCifiST, alors
- D6 deviendra "PaCi" et D7 "fiST", A0 pointera vers le début d'une zone
- mémoire spéciale (probablement $FFFF8100). Vous avez intérêt à être en
- mode superviseur pour accéder à cette zone, même si ce n'est pas nécessaire
- POUR LE MOMMENT.
- L'émulateur TOSBOX de Mark Slagell utilise la même méthode de détection.
-
- Reportez-vous au fichier EMUDTECT.TXT pour davantage d'information et
- un exemple de source assembleur.
-
-
-
- 4.9 Freezing/Unfreezing [*NOUVEAU*]
- -----------------------
-
- Apparu dans la version 0.48 de PaCifiST, ces 2 commandes du moniteurs ("fz"
- pour FreeZe et "uz" pour UnfreeZe) permettent de littéralement geler la
- machine émulée et son contexte de manière à la restaurer plus tard.
-
-
- Limitations:
- ============
-
- ATTENTION!!! CES DEUX COMMANDES PEUVENT PLANTER VOTRE PC MECHAMMENT SI
- VOUS N'Y PRENEZ PAS GARDE. En particulier ne les employez JAMAIS lorsque
- PaCifiST utilise des partitions "mountées". De même, tout le contexte n'est
- pas restauré, par exemple les images de disquette (.ST et .MSA) ne seront
- pas insérées dans les lecteurs, ce sera *A VOUS* de le faire.
-
- Il ne faudra donc JAMAIS freezer lors des chargements.
-
- Les fichiers freezés ne seront surement pas compatibles entre 2 versions
- de PaCifiST!
-
- Vous devez IMPERATIVEMENT utiliser le même TOS entre un freeze et un
- unfreeze, car il n'y a pas de changement automatique.
-
- Dans la version 0.48, les fichiers FRZ sont très gros, dans le futur il
- le seront bien moins. Evitez donc de freezer lorsque vous avez plus de
- 1 Mo de RAM émulée!
-
-
- Utilisation:
- ============
-
- Sous le moniteur, la commande "fz" attend 2 paramètres, le premier étant
- obligatoire: le nom du fichier qui sera créé (8 caractères, sans extension).
- A la suite, vous avez la possibilité de taper un commentaire. Par exemple:
-
- fz sent197 The Sentinel, level 197
-
- Va créer un fichier SENT197.FRZ. Pour le recharger plus tard:
-
- uz sent197
-
- Pour voir la liste des fichiers FRZ (avec leurs commentaires):
-
- uz
-
-
- 5. Le Moniteur
- ==============
-
-
- 5.1 L'écran du Moniteur
- -----------------------
-
- La barre bleu tout en haut de l'écran contient un mini rappel des touches de
- fonctions les plus utiles, ainsi que les modes d'émulation vidéo et de vitesse
- en cours.
-
- En dessous se trouve le contenu des registres du 68000, une estimation de la
- vitesse relative de l'émulation ainsi que la ligne raster actuelle.
-
- Sur la droite: Le contenu de la pile courante (USP ou SSP), une liste des
- breakpoints (points d'arrêts), breakaccesses (accès d'arrêts), breakopcode
- (opcode d'arrêt).
-
- La fenêtre du haut montre en permanence un désassemblage des instructions
- 68000 autour du PC. Un "*" placé devant une instruction indique un breakpoint
- à cet adresse.
-
- Vous pouvez utiliser CTRL-Z pour tracer une instruction (step into), CTRL-T
- faisant la même chose sans entrer dans les sous-programmes (trace over).
- CTRL-U peut être utilisé quand le mode trace du 68000 est actif, pour passer
- chaque instruction. PaCifiST permet en effet de "tracer le mode trace".
- CTRL-G est une alternative à la commande <go>.
-
-
- 5.2 Les commandes du Moniteur
- -----------------------------
-
- Certaines commandes nécessitent une version "DEBUG" de PaCifiST. Parce que
- cela ralentit l'émulation, elle n'est pas inclus dans les distributions
- normales de l'émulateur.
-
- Les paramètres entre parenthèses sont optionnels.
-
- [*NOUVEAU*] Avec la version 0.48, vous pouvez utiliser des expressions
- mathématiques dans les commandes.
-
- h,help,? Rapide résumé des commandes
- t Trace une instruction à la fois, exceptés les BSR, JSR & TRAP
- qui sont exécutés complètement (appuyez sur une touche pour
- interrompre cette exécution).
- z (n) Trace une seule instruction. Si une interruption se produit,
- elle sera déclenchée immédiatement. Le mode trace peut
- également être tracé.
- d (adr) désassemblage sur quelques lignes
- g (n) "go". Exécution, lancer l'émulation.
- m (adr) affiche un dump de la mémoire (hexa & ascii).
- bp (adr) ajoute ou enlève un point d'arrêt. Cela ne modifie pas du tout
- la mémoire, vous pouvez placer un breakpoint AVANT même qu'une
- routine ne soit chargée à cette adresse. Evitez d'utiliser
- des points d'accès comme première instruction d'une routine
- d'exception (mieux vaut alors se servir de la commande TRAP).
- ba (adr) ajoute ou enlève un breakaccess (accès d'arrêt). Toute lecture
- ou écriture à cette adresse particulière interrompra
- l'émulation. Attention: un accès d'un mot à $10000 ne
- déclenchera pas un accès d'arrêt à $10001.
- bar/baw (adr) [*NOUVEAU*] Déclenche les breakaccesses seulement en lecture
- ou en écriture.
- bo <msk> <cmp> définit un opcode d'arrêt (break opcode). Un seul utilisable.
- Tous les opcodes sont ANDés avec le premier paramètre puis
- comparés avec le second. Par exemple <bo ffff 4e75> stoppera
- l'émulation à chaque instruction RTS rencontrées. Pour supprimer
- le breakopcode, utilisez <bo 0 1>.
- e <expression> evaluation d'une expression
- s reg=<value> Change la valeur d'un registre 68000.
- s [adr]=<octet> change la mémoire (même la ROM). Par exemple "s [1230] = 4e 71"
- mettra un $4e en $1230 et un $71 en $1231.
- nop <adr> <n> Remplit la mémoire à <adr> avec <n> instructions NOP.
- lb <nom> <adr> (taille) charge un fichier en mémoire.
- sb <nom> <adr> <taille> sauve une partie de la mémoire sur disque.
- reset (hard) Effectue un RESET du ST émulé. (+hard pour reset à froid)
- trap (vecteur) Cette commande vous permet de stopper l'émulation 68000 quand
- se produit une exception de numéro donné. TRAP seul donne
- une liste des vecteurs importants de l'Atari ST.
- animate <n> Cette commande trace <n> instructions, en écrivant dans le
- fichier de LOG défini dans PACIFIST.INI le contenu des
- registres 68000 à chaque pas.
- status Affiche des informations sur le MFP & les lecteurs ST.
- disa <debut> <fin> Désassemble une partie de la mémoire.
- kbd (octets) Affiche ou ajoute des octets dans le buffer interne du 6301.
- kbdelay [n] Examine ou change la valeur de la variable KBDVALUE
- vol (volume) définit le volume (de 0 à 255), ou affiche le volume actuel.
- x eXit. Retour au DOS.
- pref [on|off] Si "on" (activé), le prefetch du 68000 sera émulé. Cela ralenti
- beaucoup l'émulation, aussi mieux vaut n'entrer dans ce mode
- que temporairement, quand nécessaire (pour passer le boot de
- la BIG DEMO par exemple)
- patch [off|...] Change le comportement normal de PaCifiST pour passer certains
- programmes. Le seul patch actif actuellement est "joy". Essayez
- le quand le bouton du joystick ne semble pas marcher.
- calib Entrer dans le monde de calibration du joystick PC.
- tos changer le TOS actuel, si plusieurs ont été listés dans le
- fichier INI. Bien sur le ST est reseté.
- record [on|off] Enregistrement de musique YM. PaCifiST doit avoir été lancé
- avec le switch /ymrecord. Si aucun argument n'est donné,
- le statut actuel de l'enregistrement est affiché.
- Si la commande <play> a été utilisé avant, les paramètres
- éventuellement spécifiés alors sont utilisés.
- play <start> <end> <loop> rejoue le buffer YM.
- fz <nom> [commentaire] freeze le contexte du ST émulé [*NOUVEAU*] Attention:
- Lisez bien le paragraphe 4.9 avant d'utiliser cette option.
- uz [nom] Affiche la liste des fichiers FREEZE ou restaure le
- contexte du ST émulé [*NOUVEAU*]
-
-
- Les commandes suivantes nécessitent une version "DEBUG" de PaCifiST:
- bp, ba, bar, baw, bo, trap
-
-
-
- 5.3 Evaluateur d'expressions [*NOUVEAU*]
- ----------------------------
-
- Au lieu de taper "d 4000" pour désassembler à $4000, vous avez maintenant
- la possibilité de passer des expressions mathématiques comme paramètres,
- par exemple (a0+d0)*2
-
- Opérateurs Supportés: + * - / == > < && || & | ^ ~ >> << ( )
-
- Les nombres sont par défaut héxadécimaux, mais les registres 68000 étant
- évalués, a7 n'est pas le nombre décimal +167 mais le poiteur de pile. Pour
- forcer le contraire, utilisez $A7. Des nombres décimaux peuvent être
- entrés, si précédés de # ou \.
-
- Des références à la mémoire sont possible, en utilisant [] pour un mot
- long. Par exemple "d [70]" désassemblera la routine VBL. [].b ou [].w
- désignera seulement un octet ou un mot.
-
-
- 6. Ressources & Remerciements
- ===============================
-
- 6.1 Programmes connexes
- -----------------------
-
- 6.1.1 Autres émulateurs
- -----------------------
-
-
- - STonX Ecrit par Marinos Yannikos(nino@complang.tuwien.ac.at)
- et Martin Griffiths (mgriffiths@ea.com).
- Il s'agit d'un émulateur freeware pour Unix livré sous
- forme de sources. Une version DOS existe également,
- portage réalisé par Dirk Jansen. Le site officiel est:
- http://www.complang.tuwien.ac.at/nino/home.html
- LA homepage de la version DOS est hébergée par
- EmuCamp, le site de Zoop!
-
- - Gemulator 96 Il s'agit d'un émulateur commercial. Il est rapide mais
- ne peut utiliser que des applications Atari ST 100%
- systèmes. Gemulator Classic, plus vieux et sous DOS
- est quant à lui gratuit. Site officiel:
- http://www.emulators.com
-
- - NoSTalgia C'est un émulateur très récent, écrit par Philippe
- Gerin (philippe.gerin@advalvas.be). Il est conçu pour
- MAC (PPC et 68000 dans sa dernière version)
- et semble particulièrement bon.
- http://users.skynet.be/sky39147/
-
- - TOSBOX Un émulateur ST tout nouveau, utilisable sous DOS.
- Son auteur, Mark Slagell (bald_soprano@usa.net), a
- bien travaillé: TOSBOX est basée sur une émulation
- du système. De ce fait, lui et PaCifiST sont tout
- à fait complementaires.
-
- - WINSTON Le plus récent de la liste. Comme son nom le laisse
- entendre, il fonctionne sous Windows. Dès sa
- première version, cet émulateur était déjà très
- bon, il a donc un avenir radieux. Homepage:
- http://www.winston.fatal-design.com
-
- 6.1.2 Utilitaires
- -----------------
-
- AssiST - Aengus Jankowsky (ajankows@iol.ie)
- http://homepages.iol.ie/~ajankows/st/assist/assist.html
-
- Un utilitaire qui configure PaCifiST pour vous par l'intermediaire
- d'un menu très clair. Ce programme est recommandé aussi bien pour les
- novices que les habitués de la scène de l'émulation.
- Une version Windows95 remplace AssiST à présent: AssiST97! Réalisée
- par Aengus et Gerard Butterly.
-
- PaCiLOAD - Andrew Knipe (alk@bluesky.net.au)
- http://www.labyrinth.net.au/~contact/paciload.zip
-
- Une interface de configuration sous Windows. Facile à utiliser,
- elle peut également convertir des fichiers .MSA vers .ST avant de
- démarrer de l'émulateur.
-
- MSAtoST - Damien Burke (st@jetman.demon.co.uk)
- STtoMSA http://www.jetman.demon.co.uk/st/index.html
-
- deux convertisseurs pour faire passer les fichiers MSA en ST et
- vice-versa. De nombreux programmes Atari ST sur Internet sont
- sous forme d'archives MSA.
-
- IMGBUILD - Frederic Gidouin (frederic.gidouin@hol.fr)
- http://www.pacifist.fatal-design.com/
-
- Un petit utilitaire pour créer des fichiers images .ST à partir
- de vraies disquettes. Il ne peut pas lire les disquettes 11 secteurs
- ni les formats exotiques.
- ImgBuild peut aussi créer des images "vierges".
-
- Désolé, par manque de courage, de temps et de place cette liste est très
- incomplète. D'autres utilitaires existent:Fuji Bar, PaCifiGUI, PaCigo 97
- (et maintenant 98), MSA2ST, MakeDisk, ParaLink, PaCifiST Dragon.
- Reportez-vous à la page Internet de PaCifiST pour Plus d'infos.
-
-
- 6.2 Ressources
- --------------
-
- PaCifiST-Support Sites:
- =======================
-
-
- - http://www.pacifist.fatal-design.com/
-
- La page officielle de PaCifiST. Vous y trouverez les dernières
- infos, version de l'émulateur & plein de liens.
- programmation HTML & design du site faits par Rich!!
-
- - Demonburps Emporium [http://ireland.iol.ie/~ajankows/st/pacifist.html]
-
- Contient plusieurs versions de PaCifiST et de AssiST. Quelques
- images de disquettes (jeux), des TOS et des liens.
- Aengus a été un pionnier dans la scene de l'émulation ST avec son
- site web.
-
- - The Little Green Desktop [http://www.fatal-design.com/desktop/]
-
- Un incroyable site, plein de bonnes idées. Il est maintenu par
- Rich(ard) Davey a qui la communauté de l'émulation ST doit une
- fière chandelle: FujiBBS, archives de centaines d'images de
- disquettes, liste de diffusion sur PaCifiST...
-
- - http://www.geocities.com/SiliconValley/Park/9967/
- - http://www.jetman.demon.co.uk/st/index.html
- - http://www.geocities.com/SiliconValley/Park/5000/index.html
- - http://www.geocities.com/SiliconValley/Lakes/8711/
- - http://users.iol.it/mamo7
- - http://home.pages.de/~stefansworld/pacifist/st_page.htm
- - http://www.geocities.com/area51/corridor/8458/
- - http://www.geocities.com/SiliconValley/Way/8264/index.html
- - http://users.powernet.co.uk/sterling/pacifist/
- - http://dspace.dial.pipex.com/chriscox/home.htm
- - http://hem.passagen.se/win95/index.htm
- - http://www.ohz.north.de/user/ruediger/home.htm
-
-
- Autres Pages Web
- ================
-
- - http://www.mygale.org/09/leonard/
-
- La page de Arnaud Carré, présentant notamment son incroyable STSOUND,
- un player capable entre autre d'émuler à la perfection la puce sonore
- YM2149. Des centaines de musiques au format .YM sont disponibles.
-
- - http://www.why.net/home/adam/cem/toc.html
-
- La FAQ de comp.emulators.misc, maintenue par Adam Roach.
-
-
- 6.3 REMERCIEMENTS
- -----------------
-
- Je voudrais remercier tout particulièrement les personnes suivantes pour leur
- soutien & leur feedback.
-
- Darren Birks
- Damien Burke
- Arnaud Carre
- Stuart Campbell
- Jan Alexander Corsini
- Chris Cox
- Richard Davey
- Ulrich Doewich
- Laurent Fargues
- Flix
- Ben Fozard
- Peter Fransson
- Philippe Gerin
- Carolyn Horn
- Aengus Jankowsky
- Johan Klockars
- Andrew Knipe
- Patrice Lindivat
- Bruno Mathieu
- Jonathan McHugh
- Mike Mee
- Stefan Meier
- Andreas Muegge
- Ludovic Olivencia
- Ed Olmos
- Jamison Pitcher
- Matthew Prest
- Alan Reeve
- Mauro Rossetti
- Mark Slagell
- Simone Voltolini
- Arsene Von Wyss
- Zoop
-
- Et bien sûr un GRAND MERCI à toutes les personnes qui m'ont encouragé par des
- contributions matérielles.
-
- Le logo utilisé en en-tête de cette doc a été dessiné par Senser de
- Nitrophusion (merci!).
-
- Merci à Emmanuel Loyon pour son évaluateur d'expression, sur lequel est
- basé celui de PaCifiST.
-
-
- 6.4 POUR ME CONTACTER
- ---------------------
-
- N'hesitez pas à me contacter pour si vous avez des suggestions, des
- remarques ou...des dons à faire!
-
- adresse électronique:
- frederic.gidouin@hol.fr
- adresse postal:
- Frederic Gidouin
- 9, Allee du Chevrefeuille
- 29280 Plouzane
- FRANCE
-
-